Cream of the Crop 12/Cream of the Crop 12 (Part II)/Cream of the Crop 12 (Part II).iso/OS2/DRGTXT12.ZIP/DT12.003

OS/2 Help File | 1996-03-31 | 43.1 KB | 1,160 lines

ΓòÉΓòÉΓòÉ 1. Getting Started ΓòÉΓòÉΓòÉ

DragText's Basic features add drag-and-drop text features to many commonly used
windows:  entryfields, listboxes, etc.  With DragText, you can copy or move
text between these windows using drag-and-drop, delete text by dragging it to
the Shredder, and enter a filename by dropping the file's icon into a window.
The Basic features are offered without charge and require no registration.

DragText's Extended features provide seamless integration of text with files,
directories, and WebExplorer Url objects.  Drag text to a Workplace folder to
create a file whose title is derived from the text;  drop this DragText file on
any supported window to recover the text.  You can drop a file from any source
on a multiline entryfield to insert its contents.

If the dragged text is a URL, DragText will create a WebExplorer Url object
whose title is based on the URL.  These objects can be dropped on WebEx or on
any supported window to insert the URL.

Dropping a Workplace folder on a multiline entryfield will insert a formatted
listing of the files.  The formatting is completely configurable, as are the
criteria for selecting files to be included. You can even use this facility to
write simple batch files.

The Extended features are offered as shareware and require registration to
prevent them from becoming disabled after your 6-week free trial ends. See the
section on Registration details.

DragText's features work with many commonly used applications, such as the
System Editor (e.exe) and most programs in the Internet Access Kit. It is
designed to add these features only to windows which lack them. It should never
replace or interfere with the drag-and-drop support provided by your
applications.

Because its features are added-on, not built-in, it may not work for every
possible window and conflicts may arise between DragText and some programs. If
a conflict occurs, DragText can be partially or totally disabled for that
program using the Disable page in the Options Notebook.

Installation / Removal
Running DragText
Using DragText
Options Notebook
Product Information


ΓòÉΓòÉΓòÉ 1.1. Installation / Removal ΓòÉΓòÉΓòÉ

Installation
The installation program (DTSetup.exe) will:
        -  move DragText's files to the directory of your choice
        -  create a program object for DragText.exe and put it (or a shadow) in
           your Startup Folder and/or on the Desktop
        -  offer you a choice of two methods for giving DragText files their
           own icon: either a Workplace class (preferred) or a program object
           for your editor
        -  insert several entries in os2.ini to disable DragText for programs
           known to be incompatible, and
        -  display some information specific to your system.

 Removal
 To remove DragText from your system, you can either:
        -  run DTSetup and choose "Uninstall" to partially or completely remove
           it, or
        -  simply remove the program object from your Startup Folder to keep it
           from running.

 In either case, you will have to restart your system to remove it from memory
 if it was previously loaded.

 Running DragText
 Using DragText
 Options Notebook
 Product Information


ΓòÉΓòÉΓòÉ 1.2. Running DragText ΓòÉΓòÉΓòÉ

The first time DragText.exe is run during a session, it loads itself into
memory, displays a copyright message for 3 seconds, and then terminates.
DrgTxt12.dll, which implements the drag-and-drop features, remains resident for
the rest of the session.  You will not see DragText in any list of windows or
tasks.

All supported windows created AFTER DragText.exe is run will provide
drag-and-drop; those created before will not (this is the primary reason for
putting DragText in your Startup Folder).

Running DragText again will bring up the Options Notebook which has pages that
let you:
        -  set Options such as the default drag action
        -  configure the settings for Files , Directories, and Urls
        -  Disable DragText for particular programs
        -  provide Info about supported windows and the icons and pointers
           DragText uses
        -  get DLL info such as usage and errors, and
        -  review Product Information and enter your registration number

 Installation / Removal
 Using DragText
 Options Notebook


ΓòÉΓòÉΓòÉ 1.3. Frequently Asked Questions ΓòÉΓòÉΓòÉ

   1. Q:  Why doesn't DragText show up on my window list or task list?

      A:  DragText is NOT a task, process or window, so it won't appear in
      these lists.  Once you load it into memory (by running DragText.Exe), it
      stays there until you reboot.  (If you use Pstat or Watchcat, you will
      see DrgTxt12.Dll is in the list of dll's that have been loaded.)

   2. Q:  I completely disabled DragText for program X, but I can still drop
      text into program X's window.  Why doesn't Disable work?

      A:  You can only disable DragText for windows where DragText controls
      drag and drop.  You can tell when it is in control because the mouse
      pointer will include the letters "DT".  If you've enabled DragText's
      file-creation feature, you cannot prevent other programs from reading
      files it creates.  In this case, program X is in control and will let you
      transfer text using a DragText file.

   3. Q:  I set up my mouse so the left button is the "drag button", like in
      Windows.  How come I can't drag any text?

      A:  All the windows that DragText supports use the left button to move
      the cursor and select text.  These functions completely override any drag
      function assigned to this mouse button.  IBM would have to rewrite the
      software for these windows to change this.  You can still use DragText to
      insert a file's name or contents into a window.

   4. Q:  I dropped text on the Desktop and created a file.  Later, when I
      dropped this file into my editor, the editor crashed.  What happened?

      A:  The file's name was longer than your editor could handle.  On an HPFS
      disk, a file's real name can be up to 255 characters;  the DragText
      default is 32.  You may want to shorten the names assigned to new
      DragText files.  On the Files page of the  Options notebook, change the
      number of lines and/or the number of characters per line.  (This
      shouldn't happen on a FAT disk because the system shortens real names to
      8 characters.)

   5. Q:  Why doesn't DragText work for one particular window in my program
      when it works for all the others.

      A:  There are at least three possible reasons:
             -  your program already supports drag and drop for this window;
                since drag and drop isn't a visible feature, you may be unaware
                of it;
             -  the program may have installed some sort of special handling
                for this window that completely bypasses DragText;  an example
                of this is the Point Size combobox in the standard OS/2 Font
                dialog;
             -  the program may have created a new type of window based on an
                existing type;  the new type looks and acts very much like the
                old type but has a different name, so DragText doesn't
                recognize it.

   6. Q:  How do I change the default icon for DragText files?

      A:  If you chose to install the "DTFile" WPS class, create an icon file
      named "MYFILE.ICO" and put it in your DragText directory. If you chose
      instead to create the "DT Editor" program object, drop your icon onto the
      General page of this object's notebook.  In either case, you will have to
      reboot for this to take effect.

   7. Q:  The Settings notebook for a DragText file shows three entries under
      "Current types".  Are they necessary?

      A:  Yes.  The first (",Plain Text," with commas before and after) works
      around an incompatibility between the Workplace Shell and the system's
      drag and drop functions.  If you chose the "DT Editor" option during
      installation, your editor is associated with this type. The second
      ("Plain Text") associates these files with an editor if you chose the
      "DTFile" WPS class;  it also avoids problems when using System Editor.
      The third ("DragText") is used by the DTFile class and by DragText itself
      to identify these as DragText files.


ΓòÉΓòÉΓòÉ 2. Using DragText ΓòÉΓòÉΓòÉ

When all features are enabled, DragText lets you use drag and drop to
        -  copy, move, or delete text
        -  create files and WebExplorer Url objects
        -  insert the contents of files and Url objects in text windows
        -  create a formatted listing of a folder's directory

 To help you identify the results from a drag and drop operation, DragText uses
 up to six icons and three pointers.  These results can be changed by using
 modifier keys or by setting DragText's default actions to suit your needs.
 All of this is explained in detail in the following sections.
        -  Text, Urls, Files, and Folders

        -  Icons and Pointers

        -  Modifier Keys and Defaults

        -  Supported Windows

 Options Overview
 Files Overview
 Getting Started
 Running DragText


ΓòÉΓòÉΓòÉ 2.1. Text, Urls, Files, and Folders ΓòÉΓòÉΓòÉ

Dragging Text
To drag text out of any supported window , highlight it, then begin dragging
from anywhere within the window. You do not have to point at the selection nor
does it have to be visible (e.g. in an MLE, you can scroll it out of view).
(Note: for single-line Entryfields begin dragging without any highlighting to
drag the entire contents of the field.)

As you move the pointer over different windows, the icon and pointer will
change to indicate what will happen if you drop the text at that point. For
DragText-enabled windows, the text will be inserted into editable fields and
matching text will be selected in listboxes and readonly spinbuttons (see
restrictions below). You can delete text by dragging it to the Shredder.

When the Extended features are enabled, dropping text into a Workplace folder
will create a file, or a WebExplorer Url object if the text was a Url.

You may also be able to insert text into a window that is not DragText-enabled
if the program permits you to drop a file on it.  In this case, DragText's
"create a file" icon will be visible, not its "insert text" icon. You must have
the Temporary Files option turned on for this to be successful.

Dragging Files and Folders
With the Basic features, you can drop a file or folder into any supported
window to insert its fully-qualified name.  Using the Extended features, you
can drop a DragText-created file into any window to insert its text.  You can
also insert the contents of any file into a multiline entryfield by pressing
Alt before you drop it.  Press Alt before you drop a folder to insert a
formatted listing of its directory.  The formatting is controlled by the
settings on the Directory Options page (Files->Dirs) of the Options notebook.

Restrictions:  While you can copy text from any supported window , you can only
move or delete text from editable windows (i.e. those which aren't read-only or
listboxes).  Similarly, you can only move text into editable windows.  To
comply with CUA standards, you cannot copy text onto itself;  you can override
this by pressing Ctrl before you drop. Also, you can only drop one file icon
into a window at a time.

Using DragText
Icons and Pointers
Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.2. Icons and Pointers ΓòÉΓòÉΓòÉ

DragText uses mouse pointers to indicate whether DragText itself controls what
will happen.  If it is in control, DragText will change icons as you drag to
show what will happen if you make a drop.  When your drop creates a new file,
DragText assigns the file a default icon.

Pointers
Whenever you drag text or a file over a window that DragText controls, the
mouse pointer will always include the letters 'DT', and DragText will decide
whether a drop is permitted.  If the pointer does not say 'DT', the program
that owns the window is in control and it determines whether a drop is
acceptable.  In this case, there is nothing DragText can do to prevent the
program from accepting a drop.

DragText uses three pointers:

           Insert - text will be inserted into editable fields; text will be
           matched and selected in listboxes and spinbuttons
           Replace - used only for single-line entryfields to indicate that
           dropped text will completely replace the current contents.  Press
           and release the Insert key in a normal fashion to toggle between
           insert and replace.
           Illegal - DragText will not permit a drop

 Drag Icons
 With all Extended Features enabled, DragText switches among six different
 icons. If only the Basic Features are enabled, it uses two.  This feature is
 disabled if you have one of the original versions of OS/2 Warp because of a
 bug in them (see Change Icons for more information).

 DragText uses these icons:

           Text - text will be inserted into editable fields; matching text
           will be selected in listboxes and readonly spinbuttons [Basic and
           Extended features]. This icon is also used when you drag a
           DragText-created file over any DragText-enabled window [Extended
           features].

           Note:  if Change Icons is disabled, this is the only icon that will
           be used.
           File - this icon never appears over a DragText-enabled window.  Over
           the Workplace Shell, a drop will create a file; elsewhere, text will
           be transfered to the target program via a file [Extended features].

           WebExplorer Url (not shown here) - if the text you are dragging is a
           URL, this icon appears after you leave a DragText window.  Over the
           Workplace Shell, a drop will create a WebExplorer Url object;
           elsewhere, text will be transfered to the target program via a file
           [Extended features].
           File Name - when you drag a file or folder over a DragText window,
           this icon replaces the original to show that the file or folder's
           fully qualified name will be inserted [Basic and Extended features].
           File Contents - appears only when dragging a file over a multiline
           entryfield (you may have to press the Alt key).  The file's contents
           will be inserted [Extended features].
           Folder Contents - appears only when dragging a folder over a
           multiline entryfield (you must press the Alt key).  A listing of the
           folder's contents will be inserted [Extended features].

 File Icon
 The default icon assigned to files DragText creates is the same as the file
 icon shown above.  To avoid wasting disk space, DragText files share a single
 icon.  Depending upon the choice you made during installation, this icon is
 supplied by either a Workplace Shell class (DTFile) or a program object
 associated with DragText files (DT Editor).  In either case, you can change
 the default to an icon of your choice:

     DTFile class - create an icon file named "MYFILE.ICO" and put it in your
      DragText directory.

     DT Editor object - drop your icon onto the General page of the notebook
      for this program object.

 Using DragText
 Text, Urls, Files, and Folders
 Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.3. Modifier Keys and Defaults ΓòÉΓòÉΓòÉ

Modifier Keys
DragText uses standard modifier keys and adds two others to override the
default action.  Except for the Insert key, press and hold them before you
drop, NOT when you begin a drag.  For Insert, press and release immediately
while over an entryfield;  do NOT hold it down.

Ctrl
        -  copy text and DragText files
        -  copy text onto itself
        -  for files, insert the file's formatted directory entry rather than
           its fully-qualified name (this usage may change in future versions)

 Shift
        -  move text
        -  copy a DragText file then delete it
        -  you can never move folders or files from other sources

 Alt
        -  over multiline entryfields only, insert a file's contents
        -  over multiline entryfields only, insert a folder's directory listing

 Insert
        -  over a single-line entryfield, toggle between inserting the dropped
           text into the current contents, and replacing the current contents
           with the dropped text.

 Defaults
 In all cases, the default operation is Copy.  You can change these defaults:

 On the Options page
        -  copy/move text within a window
        -  copy/move text between windows
        -  insert/replace text in entryfields

 On the Files page:
        -  copy/move text from a window into a DragText file
        -  copy/move a DragText file into a window
        -  insert a file's name/contents into a multiline entryfield

 Using DragText
 Text, Urls, Files, and Folders
 Icons and Pointers
 Options Overview
 File Overview


ΓòÉΓòÉΓòÉ 2.4. Supported Windows ΓòÉΓòÉΓòÉ

DragText works with six commonly-used types of windows found in most every
application.  They may be used as the app's main window, or only in its dialogs
and notebooks.  An example of each window appears on the Info page in the
Options Notebook

Entryfield
usually contains a single piece of information, such as a filename.

     to drag the entire contents, don't highlight any text, just drag
     to replace the entire contents, quickly press and release the Insert key
      while over the field.  The mouse pointer will change to show that you're
      in Replace mode.

 Multi-line Entryfield
 often used as the main text window in simpler apps such as the System Editor.

     insert the contents of any file by pressing the Alt key before you drop
      the file's icon.
     enter a formatted listing for a directory by pressing the Alt key before
      you drop the folder's icon (see Directory Listing Options for details).

 Listbox
 dropping text will cause DragText to search for a matching item. If found, it
 will be selected (highlighted); if not, you'll hear a beep. DragText will
 never insert text into a listbox.

 Combobox
 combines an entryfield with a listbox.  DragText handles each part as if it
 were a stand-alone window, with one exception. If the entryfield is read-only,
 dropping text on it will cause a search of the listbox for a matching entry

 Spin Button
 combines an entryfield with a button.  If the entryfield part can be edited,
 it will be handled like a stand-alone entryfield.  If it is read-only,
 DragText will search for a matching item. If found, it will be displayed;
 otherwise, you'll hear a beep.

 Static Text
 used to display text that can't be edited, such as labels and error messages.
 You can drag text from static text windows but you can never drop anything on
 them.

 Note:  You should be aware that some programs create their own window-types
 that closely resemble the standard ones.  DragText does not support these
 look-alikes.

 Getting Started
 Using DragText
 Options Notebook


ΓòÉΓòÉΓòÉ 3. Options Notebook ΓòÉΓòÉΓòÉ

Whenever you need to change DragText's defaults or get help on using it, run
DragText to open its Options Notebook.  There are four major sections, each
with a tab at the top of the notebook:

  Options     set the default actions for DragText's Basic features.

  Files       set the default actions for DragText's Extended features.

  Disable     restrict DragText's operation for any programs you specify.

  Info        get quick help, review error messages, enter your registration
  All settings take effect as soon as you press the "Apply" button, change
 pages in the notebook, or close it.


ΓòÉΓòÉΓòÉ 3.1. Options ΓòÉΓòÉΓòÉ

The two Options pages let you set the default actions for DragText's Basic
features. All settings take effect as soon as you press the "Apply" button,
change pages in the notebook, or close it.

Drag Defaults
Background Drag
Reset Notebook
Icons and Pointers
Other Options


ΓòÉΓòÉΓòÉ 3.1.1. Drag Defaults ΓòÉΓòÉΓòÉ

Between Windows
when dragging text from one window to another, this determines whether the
default action will be to copy or move the text

Within a Window
when dragging text from one part of a window to another, this determines
whether the the text will be copied or moved

These defaults can be overridden by pressing the Ctrl key (to copy) or the
Shift key (to move).

Note:  In many situations, a move operation is not possible.  If the default is
set to move, the text will be copied instead. If you explicitly request a move
by pressing the Shift key, the operation will be refused.

Drops into entryfields
When you drop text from another window into an entryfield (or the entryfield
portion of a combobox or spin button), you can choose to have it:
        -  inserted into the existing text (the initial setting)
        -  completely replace the existing text (the recommended setting)

 When set to insert, DragText's 'I-beam' mouse pointer will be used.  When set
 to replace, the mouse pointer will change to an I-beam followed by three X's.
 (See Icons and Pointers ) In use, press and immediately release the Insert key
 while over an entryfield to toggle between insert and replace.  You must be
 over a DragText-enabled window when you press Insert to avoid changing the
 system's global insert state.

 Options Overview
 Background Drag
 Reset Notebook
 Icons and Pointers
 Other Options


ΓòÉΓòÉΓòÉ 3.1.2. Background Drag ΓòÉΓòÉΓòÉ

This option keeps a DragText-enabled window from coming to the top when you
press mouse button 2 ("MB2", usually the right-hand button).  Enabling this
feature will prevent the source of a drag from covering the intended target.
Your choices are:
        -  never:  this feature is disabled
        -  always:  this feature is enabled
        -  Ctrl+MB2 only:  this feature is active only when you press and hold
           the Ctrl key as you press mouse button 2

 You can disable this feature on a program-by-program basis using the Disable
 page.

 Important:

     This option affects all MB2 actions in DragText-enabled windows. If the
      window has a popup menu, clicking MB2 will display the menu on top of all
      other windows but the window itself will remain partially covered.
     You can perform a drag even if the highlighted text is completely
      covered. Begin dragging from whatever portion of the window is visible.
     Some utility programs that add new functions to the mouse buttons may
      interfere with this DragText feature.

 Options Overview
 Drag Defaults
 Reset Notebook
 Icons and Pointers
 Other Options


ΓòÉΓòÉΓòÉ 3.1.3. Reset notebook to default size ΓòÉΓòÉΓòÉ

Each time you close the Options Notebook, DragText saves its current size,
position, and display attributes (e.g. the font used for notebook tab text).
Use this checkbox to restore all of these to their default values the next time
you run DragText.exe.  This is particularly useful if you change display
resolutions.

Options Overview
Drag Defaults
Background Drag
Icons and Pointers
Other Options


ΓòÉΓòÉΓòÉ 3.1.4. Icons and Pointers ΓòÉΓòÉΓòÉ

Pointer Size
You can choose whether DragText uses Normal sized I-beam  and Illegal  mouse
pointers or Large ones that may be more appropriate for high-resolution
displays.

Change Icons
This controls whether DragText automatically determines if it is safe to change
the icon as you drag text or files over a DragText-enabled window. See below
for a detailed explanation.  Your choices are:
        -  auto-detect:  DragText will perform the check described below.  This
           is the default.
        -  yes:  change icons, regardless of the build level.
        -  no:  do not change icons, regardless of the build level.

 Details
 When you drag text or files over a DragText window, DragText can change the
 dragged icon to identify what will happen if you drop it.  However, a bug in
 all of the original releases of OS/2 Warp v3.0 will cause the source
 application to crash if this feature is enabled.  The problem can be corrected
 by installing Warp Fixpack 8 or later (Fixpack 17 was the latest available, as
 of March, 1996).  It is also fixed in v3.01.

 At startup, DragText examines the "buildlevel" of PMMERGE.DLL to see if this
 fix is installed and then enables or disables this feature accordingly.  The
 results of its findings are displayed here (either auto-detect = yes or
 auto-detect = no). If DragText misidentifies the buildlevel, you can override
 it with this setting. To identify the buildlevel yourself, enter "ver /r" at
 an OS/2 command prompt. This feature should be enabled if the buildlevel is
 8.232 or higher.

 Cache Icons
 DragText doesn't load an icon until it is needed.  It can then save it for
 later use or it can delete it to free up memory.  Unless you run many programs
 simultaneously and are short of memory, you should probably leave caching
 enabled.
        -  yes:  leave icons in memory; this is the default.
        -  no:  delete the icon after use; this will free all icons, including
           those previously cached.

 Options Overview
 Drag Defaults
 Background Drag
 Reset Notebook
 Other Options


ΓòÉΓòÉΓòÉ 3.1.5. Other Options ΓòÉΓòÉΓòÉ

Hilite Dropped Text
When set to yes, DragText will highlight the text you drop into an editable
window.  This permits you to repeatedly copy the same text, and makes it easier
to move or delete text dropped in error.

Error Notification
This determines whether DragText notifies you when it encounters an error. When
set to beep, DragText will make a distinctive two-note beep. This is the
initial and recommended setting.  When set to None, DragText will not notify
you.

In any case, the most recent error message can be viewed on the DLL Info page.

Options Overview
Drag Defaults
Background Drag
Reset Notebook
Icons and Pointers


ΓòÉΓòÉΓòÉ 3.2. Files ΓòÉΓòÉΓòÉ

The pages in the Files section of the notebook let you set the default actions
for DragText's Extended features.  All settings take effect as soon as you
press the "Apply" button, change pages in the notebook, or close it.

File Options
WebExplorer Url Defaults
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.1. File Options ΓòÉΓòÉΓòÉ

File and Url Titles

Lines:  the maximum number of lines the title will use when displayed in a
Workplace folder

Chars:  the maximum number of characters in each line

+/- Chars:  DragText can add or subtract this many characters to a line to
avoid splitting a word in two

Replace punctuation with:  this character will replace one or more consecutive
spaces, punctuation, and control characters in file titles (but not in Url
titles)

DragText Files
This applies to the files DragText creates.  You can override these settings by
pressing Shift to move or Ctrl to copy.

Text to File:  when you drop text on the Workplace to create a file, you can
either copy or move (i.e. delete) the text from the source window

File to Text:  when you drop a DragText file on a supported window, you can
either copy or delete (i.e. move) the file

Other Files
These are files DragText did not create.  You can toggle this setting by
pressing Alt.

Other Files to MLEs:  when you drop a file DragText didn't create on an MLE
(multi-line entryfield), DragText will insert either the file's complete name
or the file's contents. If it inserts the contents, DragText will rplace all
nulls with spaces and remove any trailing end-of-file (Ctrl-Z) character.

Create Files
Check this box to enable DragText to create files.

Read Files
Check this box to enable DragText to read files and subdirectories.

Files Overview
WebExplorer Url Defaults
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.2. Directory Listing Options ΓòÉΓòÉΓòÉ

If you drop a Workplace folder on a multiline entryfield while pressing Alt,
DragText will insert a formatted listing of the files in that disk directory.
This listing will not include non-file objects (such as program objects or
shadows).  This feature can be used to create simple batch files, as shown in
Example 2 below.

Include:  like any request for a directory listing, this determines which files
will be included.  The default is "*"  which includes all files.  You could
change this to "*.exe" to include only programs, or to "a*" to include only
files whose names begin with the letter "a".

Flags:  this lets you include or exclude files based on their standard
attributes: Directory, Read-only, Archived, Hidden, and System.  Plus ("+")
includes files with that attribute while minus ("-") excludes files with the
attribute. Equal ("=") requires a file to have the attribute to be included.
The default value of all pluses includes all files.  Setting the flags to "+D
-R +A =H +S" would produce a listing of hidden files that weren't also
read-only

Listing Format:  controls the formatting for each file in the listing.  You can
enter meta-characters (see below), fixed text, tabs, and carriage returns.
(Note: you must include a carriage return if you want each entry to appear on a
separate line.)  The default value is "%#  %d  %t %s %a %f" , followed by a
carriage return.  If you erase the contents of this field, DragText will fill
in the default value;  it cannot be left blank.

Heading Format:  produces a heading for your listing.  You may include fixed
text, control characters, and the meta-characters for the path and file.  The
file meta-character will be replaced by the search string.  If this field is
left blank, no heading will be produced.

Meta-Characters
These represent the various components of a directory listing:

 %p        pathname as it appears on the disk with both upper and lowercase
           letters
 %P        pathname with all letters converted to uppercase

 %f        filename as it appears on the disk with both upper and lowercase
           letters
 %F        filename with all letters converted to uppercase

 %n        filename without its extension with both upper and lowercase letters
 %N        filename without its extension with all letters converted to
           uppercase

 %e        filename extension with both upper and lowercase letters
 %E        filename extension with all letters converted to uppercase

 %d        file date (same as %D) using your country's standard format
 %D        file date (same as %d) using your country's standard format

 %t        file time as HH:MM (plus AM or PM if you use a 12-hour clock)
 %T        file time as HH:MM:SS (plus AM or PM if you use a 12-hour clock)

 %s        file size to a maximum of 7 digits;  if the size is 10 million or
           more, this field will contain 7 asterisks (i.e. "*******")
 %S        file size to a maximum of 10 digits

 %a        file attributes (including the directory flag) in lowercase letters
 %A        file attributes (including the directory flag) in uppercase letters

 %#        the sequence number of this entry, starting at 1

 %%        used to include a percent sign in your fixed text

 Note:  the pathname will not include a final backslash unless it is
 immediately followed by the filename

 Example 1 - verbose listing

  [Heading]  Directory listing for %p
  [Listing]  File %F was created on %d at %T

  [Output]  Directory listing for C:\DragText
        File DRAGTEXT.EXE was created on 12-25-95 at 01:10:00
        File DRAGTEXT.DLL was created on 12-25-95 at 01:10:00
        [etc.]

 Example 2 - creating a batch file

  [Heading]  cd %p
  [Listing]  ren %f %F

  [Output]  cd C:\DragText
        ren DragText.Exe DRAGTEXT.EXE
        ren DragText.Dll DRAGTEXT.DLL
        [etc.]

 Files Overview
 File Options
 WebExplorer Url Defaults
 Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.3. Set WebExplorer Url Defaults ΓòÉΓòÉΓòÉ

This feature works even if you do not have IBM's WebExplorer.

Create WebExplorer Urls
When checked, DragText will create WebExplorer_Url objects if that Workplace
class is registered.  If it is not registered, DragText will create a file that
is functionally identical to the object, except for the class-specific settings
notebook.  Either can be dropped on the WebExplorer to load a Url. If this box
is not checked, DragText will handle Urls like any other dragged text.

Url Identifiers
When the beginning of your text matches one of these prefixes, DragText creates
a Url object.  The default values are "http:// ftp://" .  You can add any
identifier that WebExplorer supports;  for example, you could add "gopher://".
Separate each identifier with a space.

DragText can also recognize incomplete Urls and fill in the missing identifier.
Enter the identifier surrounded by angle brackets ('<' and '>'), followed by
the letters DragText should try to match. The default values are "<http://>www.
<ftp://>ftp." .  Notice that each ends with a period:  this should keep
DragText from misidentifying sentences beginning with these letters.

Title Options
DragText uses these options, plus its own rules, to format the Url as a title.
They do not affect the object's contents.

Remove from Hostname:  to provide shorter and more meaningful titles, you can
have DragText remove unnecessary words from the hostname portion of the Url.
Each portion of the name, delimited by a dot or a slash, is compared to this
list;  if it matches, the word is eliminated.  The wildcard characters '*' and
'?' can be used.  The default values are "www* com net edu org ??" .  Using
"www*" will remove "www", "www1", "www-os2", etc.  Using "??" will remove all
two-letter words, such as country identifiers (e.g. "ca" or "de").

Line break after hostname:  when checked, only the hostname will appear on the
first line of the title. Any path information will begin on the second line.
If the hostname is long enough to wrap to line 2, no line break will be added.

Hostname only:  when checked, the Url title will include only the hostname.  No
path information will appear in the title.

Files Overview
File Options
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.4. Compatibility Options (Fixes) ΓòÉΓòÉΓòÉ

For an add-on like DragText to work with a wide range of programs, some
compromises may have to be made.  These options should be set to meet the needs
of your most commonly used applications.

Temporary Files
These settings have NO effect on your ability to create files by dropping text
on a Workplace folder. DragText's ability to create files lets you insert text
into programs that otherwise wouldn't accept dragged text.  Sophisticated
programs like the Enhanced Editor (EPM) understand that they should ask
DragText to create a file.  Simpler applications don't know how to ask and may
complain or crash if the file doesn't exist yet.  To avoid this, you can have
DragText create a file as soon as you begin a drag.  Because DragText uses a
separate thread to create the file, this shouldn't have a significant impact on
overall performance.

When drag starts:
        -  (no temp file):  this is the default setting and best if your apps
           will accept dragged text directly.
        -  create a file:  this is the most reliable setting for transferring
           text via a file.  However, there will be background disk activity
           whenever you begin a drag.
        -  create a pipe:  this setting, in effect, creates a file in memory.
           Programs that examine a file's attributes or size before loading may
           have problems using a pipe.

 File/Pipe Name:  the name DragText uses when creating a file or pipe; it is
 reused every time you begin a drag.  The name must conform to the 8.3 naming
 convention.  The default value is "DRAGTEXT.TMP".

 File Path:  the disk directory where the temporary file is stored.  The
 default value is the directory where DragText.Exe is stored.

 WebExplorer URLs

 Drop URLs directly into WebEx:  when checked, you can drag a Url directly from
 a DragText-enabled window and drop it on the WebExplorer to load it.  A
 temporary file will always be created, regardless of the settings described
 above.  You will also be unable to use this file to insert text into a program
 that isn't DragText-enabled.

 Note:  The File Path you set for DragText's temporary files must be on the
 same disk as WebExplorer when you use this option.

 Files Overview
 File Options
 WebExplorer Url Defaults
 Directory Listing Options


ΓòÉΓòÉΓòÉ 3.3. Disable ΓòÉΓòÉΓòÉ

The Disable page lets you restrict DragText's operation for any programs you
specify.

Normally, DragText is enabled for all programs.  However, if it conflicts with
an application's use of drag-and-drop, you can partially or totally disable
DragText for that program.

The "Program" section of the dialog contains a list of all applications that
currently have restrictions. The checkboxes under "Uncheck to Disable" show the
window types on which DragText operates.  If a box is checked, DragText is
enabled.

If DragText's Extended features are enabled, you can disable them for a
specific program. Uncheck Drag to disable file and WebExplorer Url creation;
uncheck Drop to disable reading files, directories, and Url objects.

You can also disable Background Drag for specific programs.

Important:  you can only disable file operations for DragText-enabled windows.
These are windows where the mouse pointer changes to one of DragText's unique
pointers (see Icons and Pointers for details).  You cannot prevent a program
that accepts dropped files from accepting text rendered as a file or Url
object.  For example, if you drag a Url from a DragText window, you cannot
prevent WebExplorer from accepting it because DragText does not control WebEx's
drag and drop features.

Add a Program to the Restricted List
Change a Program's Restrictions
Remove a Program from the List

Notes:

     Restrictions are checked when a program is launched, not during its
      execution.  To add a restriction, close the application program, add the
      restriction, then restart the program.
     Only programs with restrictions are saved.  Programs whose settings match
      the default (no restrictions) will be dropped from the list and will not
      appear next time you run DragText.  This is done to enhance DragText's
      performance.

 Conflicts with Other Programs
 Disabling DragText System-wide
 Getting Started
 Using DragText


ΓòÉΓòÉΓòÉ 3.3.1. Conflicts with Other Programs ΓòÉΓòÉΓòÉ

DragText knows very little about the programs it works with and they know
absolutely nothing about DragText.  Because of this, conflicts are possible -
particularly with applications that have their own drag and drop functions.

DragText can usually tell when a program is handling drag and drop and avoids
getting involved.  When this fails, you may get an error message or unexpected
results.

To eliminate this problem, use the Disable page to disable DragText partially
or totally for that program.  It usually isn't necessary to disable DragText
totally;  in most cases, disabling the particular type of window that is
causing trouble will suffice.  You may find that disabling only drags or only
drops for that window will solve the problem.

Restrictions are checked when a program is launched, not during its execution.
To add a restriction, close the application program, add the restriction, then
restart the program.

Note:  Most error messages arise from other problems in the system and are not
directly the result of a conflict between DragText and your application
program.

Disable Overview
Running DragText


ΓòÉΓòÉΓòÉ 3.3.2. Add a Program to the Restricted List ΓòÉΓòÉΓòÉ

Enter the name of the program (or drop its icon into the entryfield).  Path
information is not needed and will be removed when you add this entry.

To disable drag and/or drop for particular window types, uncheck the
corresponding boxes.  To disable DragText entirely uncheck "All Windows".

Press the button labeled "Add".

Change a Program's Restrictions
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.3. Change a Program's Restrictions ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Make any necessary changes.

Your changes will be saved when you select another program from the list, press
the "Apply" button, change notebook pages, or exit.

Add a Program to the Restricted List
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.4. Remove a Program from the List ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Press the "Remove" button.  The entry will be deleted immediately.
-- or --
Check all of the checkboxes (i.e. so that there are no restrictions). The entry
will be deleted when you close the notebook.

Add a Program to the Restricted List
Change a Program's Restrictions


ΓòÉΓòÉΓòÉ 3.3.5. Disabling DragText System-wide ΓòÉΓòÉΓòÉ

DragText uses only documented features of OS/2 which should continue to be
supported in future versions. Still, it is possible that unforeseen changes to
the operating system will render DragText incompatible with a particular type
of window.  To retain the bulk of DragText's usefulness, you can disable that
window type system-wide.

On the Disable page, enter <ALL PROGRAMS> (the angle brackets are required).
Uncheck both boxes for this window type, then press the "Add" button.  This
option will be in effect for all newly launched programs;  those which are
already running will not be affected.

In extraordinary circumstances, you may find it necessary to disable DragText
for all new windows in all programs.  To do this, follow the instructions
above, but uncheck both boxes next to "All Windows".  In this case, DragText
will be disabled for all new windows, including those created by programs that
are already running.  Windows that already exist will not be affected.


ΓòÉΓòÉΓòÉ 3.4. Info ΓòÉΓòÉΓòÉ

  Info     practice your drag and drop using examples of each supported window

  Icons    view each of the icons and pointers used as you drag text and files

  DLL      review usage statistics and error messages

  DT       enter your registration number, review product info


ΓòÉΓòÉΓòÉ 3.4.1. DLL Info ΓòÉΓòÉΓòÉ

The DLL Info page provides usage and error statistics for DragText.dll.

Usage
The usage section shows the number of processes (programs) that have loaded
DragText.dll and the number currently using it. The latter figure will usually
be at least 3 (two instances of pmshell.exe and DragText.exe itself).

Errors
This section displays the total number of errors encountered during this
session, the ID number of the last process to have an error, and the message
associated with that error.

When an error occurs, DragText.dll will notify you by whichever method you
choose on the Options page.  You can restart DragText.exe and refer to this
page to review the error message.

Note:  These messages are intended for debugging and diagnostic purposes.
Except for identifying conflicts with other programs, they are of little use to
the user.  All errors arise from flaws in DragText, other applications, or the
operating system. Users cannot "cause" errors.

Conflicts with Other Programs
Options Overview
Getting Started


ΓòÉΓòÉΓòÉ 3.4.2. Registration Information ΓòÉΓòÉΓòÉ

After you register DragText uou will receive a registration number.  Enter it
on the last page (Info->DT) of the Options Notebook.  Enter your name exactly
as it appears on your registration notice.  Close the notebook, then reopen it
to reset your options.

Product Information
Registering DragText
License Agreement
Options Notebook


ΓòÉΓòÉΓòÉ 4. About DragText ΓòÉΓòÉΓòÉ

                            - DragText version 1.2 -
                       The Drag and Drop Enabler for OS/2*

                       (C) Copyright R L Walsh 1994, 1995
                              All rights reserved.

                                    write to
                               [e-mail]
                                    -- or --
                                   Rich Walsh
                                315 S. Barbour St
                          Beverly Hills, Florida 34465
                                     U.S.A.

                              Registering DragText
                                License Agreement

* OS/2 is a registered trademark of International Business Machines Corp.


ΓòÉΓòÉΓòÉ 4.1. Registration ΓòÉΓòÉΓòÉ

To prevent DragText's Extended features from becoming disabled after your
6-week free trial ends, register it directly with the author ($15) or through
BMT Micro ($18).  You will receive a registration number to enter on the last
page of the Options Notebook.

Direct  - $15 (US)
Mail a check or money order drawn in *US Dollars* to:
           Rich Walsh
           315 S. Barbour St.
           Beverly Hills, Florida  34465
           U.S.A.

 Include your full name, mailing address, and email address (if available).
 Send email to:  [e-mail]

  BMT Micro  - $18 (US)

 Phone:         8:00am - 7:00pm EST (-5 GMT)
                [phone] (Orders only)
                [phone] (Orders / Order Inquires)

 Fax:           [phone] hours, 7 days a week
                [phone] 24 hours, 7 days a week

 BBS:           [phone] 10 lines, all 14.4K
                [phone] 28.8k v.FC

 Internet:      [e-mail]

 Compuserve:    Thomas Bradford, 74031,307

 telnet:        bmt.wilmington.net

 BMT Micro accepts Visa, Mastercard, Discover, American Express, Diner's Club,
 money order, cashiers checks, and personal checks. They also accept DM and
 British currency via registered mail. Personal checks are subject to
 clearance.

 BMT Micro accepts purchase orders from educational institutions, governmental
 agencies and other verifiable businesses.  Terms are "Due Upon Receipt" with a
 $250 minimum.

 Entering your registration number
 Product Information
 License Agreement
 Options Notebook


ΓòÉΓòÉΓòÉ 4.2. License Agreement ΓòÉΓòÉΓòÉ

DragText, its executables and documentation, is the copyrighted property of
Richard L. Walsh. It is licensed, not given, to you for your personal use.
Selected features require the payment of a registration fee for continued use.

You may copy and freely redistribute DragText to others, provided:
        -  the recipient agrees to the terms of this license,
        -  you transfer DragText as a whole and intact,
        -  there is no cost to the recipient other than the costs of providing
           media and transmission, and
        -  it is not redistributed in conjunction with any software that may
           not also be freely redistributed by the recipient.

 You may not modify DragText in any way nor may you reverse assemble, reverse
 compile, or otherwise translate or reverse engineer its executable code or
 data. You may make additions to the documentation, including translations into
 other languages, provided these are contained in files separate from the
 originals and are identified as addenda to the accompanying original
 documentation.

 DragText is not warranted to be free of defects nor to be suitable for any
 particular purpose the licensee may put it to. The licensee agrees to use
 DragText at his or her own risk, and agrees to accept all liabilities arising
 from its use, including all claims by third parties, without recourse to the
 author or copyright holder.

 THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR USE OF THE
 PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.

 Product Information
 Registering DragText
 Options Notebook